home *** CD-ROM | disk | FTP | other *** search
/ Risc World 7 / Risc World 7.iso / Software / Issue6 / SDL.ZIP / !gcc / docs / ld / README < prev   
Text File  |  2006-08-28  |  2KB  |  82 lines
  1. LD
  2. ==
  3.  
  4. What
  5. ~~~~
  6.  
  7. ld is a small wrapper for the ARM/RISC OS linker, called drlink, we are
  8. using in GCCSDK.  Users shouldn't invoke ld directly but use 'gcc' to
  9. do the final linking.
  10.  
  11.  
  12. Environment variables
  13. ~~~~~~~~~~~~~~~~~~~~~
  14.  
  15. By setting certain environment (system) variables you can control the
  16. behaviour of 'ld':
  17.  
  18. TLINK_VERBOSE:
  19.   When defined, it should be an integer which with increased value gives
  20.   more verbose output.
  21.  
  22.       0: no verbose output
  23.    >  0: log ld version number
  24.   >=  1: log recompile (if necessary)
  25.   >=  2: log opening repo file
  26.   >=  3: log command line to execute
  27.   >=  4: log opening via file; demangling symbol names
  28.   >=  5: log ld progress
  29.   >=  7: log temporary file creation
  30.   >= 15: don't remove temporary files
  31.  
  32. TLINK_CX11
  33.   When defined (value unimportant) and the X11 library is in the link line,
  34.   replace the X11 library with ChoX11 library and add DeskLib library as well.
  35.  
  36. TLINK_EXTRA
  37.   When defined, its value specifies extra command line arguments for the
  38.   invoked linker.
  39.  
  40. TLINK_MEMCHECK [only in cross-compile environment]
  41.   "" or "fortify"
  42.     Add the Fortify library and edit the memory allocation routines so that
  43.     the running the resulting executable get its memory allocation and usage
  44.     checked.
  45.  
  46.   "dmalloc" (http://dmalloc.com/)
  47.     Add the Dmalloc library and edit the memory allocation routines so that
  48.     the running the resulting executable get its memory allocation and usage
  49.     checked.  Use the dmalloc executable to determine the DMALLOC_OPTIONS
  50.     environment variable value suited for current memory debugging.
  51.  
  52.   Note this currently only works when the UnixLib run-time library is
  53.   used.
  54.  
  55. TLINK_STRICT
  56.   When defined (value unimportant), pass the option -strict to the linker.
  57.  
  58. COLLECT_GCC
  59. COLLECT_GCC_OPTIONS
  60.   Deprecated debugging values.  These have little practical use.
  61.  
  62. COLLECT_NO_DEMANGLE
  63.   If defined, don't demangle C++ symbols reported by drlink
  64.  
  65. GCC$Linker [not applicable for cross-compile environment]
  66.   When defined, its value specifies the underlying linker to be used
  67.   allowing e.g. the Norcroft linker to be used instead of the standard
  68.   GCCSDK drlink linker.
  69.  
  70. Note the libm, libc, libpthread and libdl libraries are not passed to
  71. the underlying linker, since these are all implied by UnixLib.
  72.  
  73.  
  74. Copyright
  75. ~~~~~~~~~
  76.  
  77. Copyright (C) 1997, 1998, 1999, 2000, 2001, 2004 Nick Burrett
  78. Copyright (C) 2005, 2006 GCCSDK Developers
  79.  
  80. Written by Nick Burrett (nick@sqrt.co.uk) and licensed under GPL v2.
  81.  
  82. -EOF-